home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / sflag110.zip / SETFLAG.DOC next >
Text File  |  1993-01-13  |  4KB  |  171 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                                                   SetFlag
  12.                                                                          
  13.                                                      Copyright (c)1992-93
  14.                                                      Cabell B. Clarke Jr.
  15.                                                       ALL RIGHTS RESERVED
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. --------------
  32. --- DISCLAIMER
  33.  
  34. This software is being released as FREEWARE.  Anyone can use it for anything
  35. they want.  It is not guaranteed to do anything but take up space on your
  36. disk.  If you break it you own both parts.  I am not responsible for
  37. anything.  If you do not believe that, just ask my kids.
  38.  
  39.  
  40. ---------
  41. --- ABOUT
  42.  
  43. SetFlag is a simple little program that will toggle user flags in your
  44. RemoteAccess USERS.BBS file from the DOS command line.  I needed a quick and
  45. dirty way to do this so I wrote this program in an afternoon.  It's no speed
  46. demon and it isn't pretty but it seems to work fine on my system.  Maybe it
  47. will work on yours.
  48.  
  49.  
  50. ---------
  51. --- FIRST
  52.  
  53. You should first place SETFLAG.EXE in some directory already in your PATH
  54. and change to the directory containing your USERS.BBS file.  If you go ahead
  55. and type SetFlag, you will hear the BEEP and see a brief summary for the
  56. Command Line Syntax.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. ----------
  67. --- SYNTAX
  68.  
  69. The syntax for using SetFlag is as follows:
  70.  
  71. SetFlag {-|/}parameters [{-|/}switches]
  72.  
  73. where parameters are required on the command line.  The supported parameters
  74. are:
  75.  
  76.      <flagnum>      a1..d8  RA User Flags
  77.      ON|OFF         turn flags ON or OFF
  78.      ?              display HELP screen
  79.  
  80. Switches are optional and tell Setflag to process one and only one user
  81. record.  Running Setflag with no switches will change ALL USERS' flags in
  82. your USERS.BBS file.  The supported switches are:
  83.  
  84.      -R<recordnumber>         specific record number
  85.  
  86.      -N<user_name>       specific User's name (*note)
  87.  
  88.           (*note - the first and last name should be separated with an  
  89.             underscore _ )
  90.  
  91.  
  92. You may preface both parameters and switches with a dash (-) or frontslash
  93. (/) character.
  94.  
  95.  
  96. Some examples are:
  97.  
  98.      SetFlag b4 on
  99. turns the b4 flag on for ALL users
  100.  
  101.      setflag A7 OFF
  102. turns the a7 flag OFF for all users
  103.  
  104.      setflag d8 on -nCabell_Clarke
  105. turns the D8 flag on for user Cabell Clarke ONLY!
  106.  
  107.      setflag off -r0 d8
  108. turns the d8 flag off for user #0
  109.  
  110.      setflag ?
  111. displays a brief HELP screen
  112.  
  113.  
  114. That's all it is to it.  There is very limited error-checking to save code
  115. space and you should remember to change to the directory containing your
  116. USERS.BBS file since Setflag will not look anywhere else for it.
  117.  
  118.  
  119. ---------
  120. --- FLAGS
  121.  
  122. In case you were wondering about conventions (and I know you were):
  123.  
  124.      ON  = TRUE  = X
  125.      OFF = FALSE = -
  126.  
  127.  
  128.  
  129. -----------
  130. --- HISTORY
  131.  
  132. 1.10
  133. ----
  134. (*)  Added the ability to process individual user records via the switches
  135.      -R and -N.
  136.  
  137. (*)  Cleaned up code a bit.
  138.  
  139.  
  140. 1.00
  141. ----
  142. (*)  Initial Release for Public Consumption
  143.  
  144.  
  145.  
  146. --------
  147. --- INFO
  148.  
  149. This program has been tested extensively for 15 minutes on my system.  Of
  150. course, there are no bugs in it, but should you want to contact me anyway,
  151. here's how:
  152.  
  153.      Cabell Clarke
  154.      The Boot Factory BBS
  155.      804-262-9289
  156.      FidoNet 1:264/19
  157.  
  158. If you like the program and want to register, send me a postcard to the
  159. address below.
  160.  
  161.      5513 Cottage St.
  162.      Richmond, VA  23228
  163.  
  164.  
  165. Also try out my ValidOOR User Verification System for RemoteAccess. A file
  166. request for magic name VDR will get you the latest release for RemoteAccess
  167. BBS.  Anyone may request in any nodelist and the program is less that 100k.
  168.  
  169.  
  170.  
  171.